% README for the OS/2 port of bind 4.9.3

\documentclass[a4paper]{article}
\usepackage{a4}
\usepackage{german}

\title{The OS/2 port of bind 4.9.3}
\author{Peter Meerwald}

\begin{document}
\maketitle

\section{What is it?}

This is release 4.9.3 of bind\footnote{Berkley Internet Name Domain} ported to OS/2.
It relies on EMX\footnote{Eberhard Mattes eXtentions -- a distribution of GCC for OS/2} 0.9b fix 5 (or newer).

\section{Installation}

To install just take a look a the standard bind documentation\footnote{look at \emph{http://www.vix.com/isc/bind.html} for a reference manual (BOG -- Bind Operations Guide), FAQ, protocol definitions, \dots}.
The directory structure for the OS/2 port is laid down in \emph{named/pathnames.h}. A re-compile is neccassary to customize directory names -- sorry.
The EMX runtime and IBM TCP/IP have to be installed.

You will find the executables in the source directories (\emph{named/}, \emph{tools/}, \emph{tools/nslookup}), make install does (of course) not work (yet).

It is a good idea to have \emph{syslogd} running the first time you start \emph{named}. Try parameter \emph{-d} for extensive debug info and/or \emph{-q} for query logging.

\section{OS/2 specific stuff}

\subsection{What happened to the code?}

Actual code is pretty unchanged, I adapted the makefiles, figured out a
suitable \emph{compat/lib/lib44bsd.a}, read \emph{conf/protability.h} very carefully :)
and while doing so my OS/2 box turned into a unix-lookalike\footnote{you may wish to get GNU shell|file|text utilities from hobbes}.

Look for \_\_EMX\_\_ defines in the code (you won't find many) to see what changed.

\subsection{Re-compiling}

Especially \emph{named/Makefile} contains one bad hardcoded hack (I was unable get
sed to work), I used tcsh 6.0.6.1 \bf and \rm bash 1.12, to me, it seems that these
shells lack some features :) - well I'm very lost when it comes to shell
setup/shell features - I am awaiting  your hints\dots

\bf News flash: \rm Try ksh 5.27 to re-compile -- works much better that tcsh and bash! Compiles the entier project in \bf one \rm pass, wow\dots

In order to re-compile the bind port you'll need a syslog library (on hobbes\footnote{point your browser to \emph{ftp://ftp-os2.nmsu.edu/os2} or \emph{ftp://ftp-os2.cdrom.com}} for IBM's CSet,
a port of the port to EMX is available from the author) and flex.

I removed the \emph{contrib/}, \emph{shres/}, \emph{doc/rfc/} directory from the original
distribution, some postscript files about DNS security were also removed.

\subsection{Sending signals}

Unix background daemons receive commands via signals that are sent to their pid\footnote{a unique number identifying a process}.
bind 4.9.3 understands a number of signals: SIGINT, SIGQUIT, SIGIOT, SIGUSR1, SIGUSR2, SIGHUP, SIGALARM, SIGTERM.

A way to send signals under OS/2 is provided in the Apache httpd port\footnote{again on hobbes or \emph{http://www.apache.org/}} in directory emph{Apache/os2/}.

\section{History of the OS/2 port}

\begin{itemize}
\item June 14, 1996 --- released \emph{bind493a.zip}
\item July 3,1996 --- \emph{bind493b.zip} contains this wonderful \LaTeX\ -README and, more important, a
fix for the ''core dump'' bug when set up as a secondary name server (well, now everything is linked static);
some cleanups were done to the Makefiles; this is just an \bf update \rm release, it contains \bf only \rm executables and this README!
\end{itemize}

\section{To do}

\begin{itemize}
\item either replace makefiles with REXX scripts or craft'em right
\item include a working sample configuration
\item find and fix bugs in the port :)
\item make named display some debug info in its window
\item provide some means to send signals to \emph{named}
\item figure out a way to have dynamic linking \bf and \rm a working fork()
\end{itemize}

\section{How to contact the author}

I'm very interested in your comments and flames.

\begin{table}[h]
\begin{tabbing}
\= snail mail address  xxxxxxxxxx \= email addresses xxxxxxxxxxx \kill
\> Peter Meerwald \> pmeerw@cosy.sbg.ac.at \\
\> Schie�standstr. 3 \> Peter.Meerwald@2-315-11-0.st.co.at \\
\> A-5061 Elsbethen/AUSTRIA \> 2:315/11@fidonet.org \\
\end{tabbing}
\end{table}

\section{Disclaimer}

Beware: I am no DNS specialist. There may be serious bugs  in the OS/2 port of bind 4.9.3 -- use at your own risk! Insert your favourite disclaimer text below\dots

\end{document}
